Node / meshtastic / Meshtastic-Android / files / androidApp / src / google / kotlin / org / meshtastic / app / map / offline / pmtiles / OfflineRegionStore.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.app.map.offline.pmtiles

Tff7b72import T7ee787co.touchlab.kermit.Logger

Tff7b72import T7ee787kotlinx.coroutines.sync.Mutex

Tff7b72import T7ee787kotlinx.coroutines.sync.withLock

Tff7b72import T7ee787kotlinx.serialization.json.Json

Tff7b72import T7ee787java.io.File

Tff7b72import T7ee787java.nio.file.Files

Tff7b72import T7ee787java.nio.file.StandardCopyOption

T8b949e/**

* Where downloaded offline regions live: one `.mbtiles` archive per region plus a JSON manifest of their metadata, all

* under `filesDir/offline_regions/`. Every mutating call takes [mutex], since a download completing and the user

* tapping delete can race.

*/

Tff7b72internal Tff7b72class T56d364OfflineRegionStoreTb4b4b4(Tff7b72private Tff7b72val Te6edf3baseDirTb4b4b4: Te6edf3FileTb4b4b4) Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3manifestFile Tff7b72= Te6edf3FileTb4b4b4(Te6edf3baseDirTb4b4b4, Ta5d6ff"Ta5d6ffmanifest.jsonTa5d6ff"Tb4b4b4)

Tff7b72private Tff7b72val Te6edf3mutex Tff7b72= Te6edf3MutexTb4b4b4(Tb4b4b4)

Tff7b72init Tb4b4b4{

Te6edf3baseDirTb4b4b4.Te6edf3mkdirsTb4b4b4(Tb4b4b4)

Tb4b4b4}

Tff7b72fun Td2a8ffarchiveFileTb4b4b4(Te6edf3idTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3File Tff7b72= Te6edf3FileTb4b4b4(Te6edf3baseDirTb4b4b4, Ta5d6ff"Tffd700$Te6edf3idTa5d6ff.mbtilesTa5d6ff"Tb4b4b4)

T8b949e/** Where a region's terrain tiles live — an [org.meshtastic.feature.map.terrain.TerrainTileStore] rooted here. */

Tff7b72fun Td2a8ffterrainDirTb4b4b4(Te6edf3idTb4b4b4: Tffa657StringTb4b4b4)Tb4b4b4: Te6edf3File Tff7b72= Te6edf3FileTb4b4b4(Te6edf3baseDirTb4b4b4, Ta5d6ff"Tffd700$Te6edf3idTa5d6ff/terrainTa5d6ff"Tb4b4b4)

Tff7b72fun Td2a8fflistTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3OfflineRegionTff7b72> Tff7b72= Te6edf3readManifestTb4b4b4(Tb4b4b4)

Tff7b72suspend Tff7b72fun Td2a8ffaddTb4b4b4(Te6edf3regionTb4b4b4: Te6edf3OfflineRegionTb4b4b4) Tb4b4b4{

Te6edf3mutexTb4b4b4.Te6edf3withLock Tb4b4b4{ Te6edf3writeManifestTb4b4b4(Te6edf3readManifestTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3filterNot Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3id Tff7b72=Tff7b72= Te6edf3regionTb4b4b4.Te6edf3id Tb4b4b4} Tff7b72+ Te6edf3regionTb4b4b4) Tb4b4b4}

Tb4b4b4}

Tff7b72suspend Tff7b72fun Td2a8ffdeleteTb4b4b4(Te6edf3idTb4b4b4: Tffa657StringTb4b4b4) Tb4b4b4{

Te6edf3mutexTb4b4b4.Te6edf3withLock Tb4b4b4{

Te6edf3archiveFileTb4b4b4(Te6edf3idTb4b4b4)Tb4b4b4.Te6edf3deleteTb4b4b4(Tb4b4b4)

Te6edf3terrainDirTb4b4b4(Te6edf3idTb4b4b4)Tb4b4b4.Te6edf3deleteRecursivelyTb4b4b4(Tb4b4b4)

Te6edf3writeManifestTb4b4b4(Te6edf3readManifestTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3filterNot Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3id Tff7b72=Tff7b72= Te6edf3id Tb4b4b4}Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

T8b949e/** Every byte a downloaded region occupies — its base vector archive plus any terrain attached to it. */

Tff7b72fun Td2a8fftotalBytesTb4b4b4(Tb4b4b4)Tb4b4b4: Tffa657Long Tff7b72= Te6edf3readManifestTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3sumOf Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3byteSize Tff7b72+ Tffa657itTb4b4b4.Te6edf3terrainByteSize Tb4b4b4}

Tff7b72private Tff7b72fun Td2a8ffreadManifestTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3OfflineRegionTff7b72> Tb4b4b4{

Tff7b72if Tb4b4b4(Tff7b72!Te6edf3manifestFileTb4b4b4.Te6edf3existsTb4b4b4(Tb4b4b4)Tb4b4b4) Tff7b72return Te6edf3emptyListTb4b4b4(Tb4b4b4)

Tff7b72return Tff7b72try Tb4b4b4{

Te6edf3JsonTb4b4b4.Te6edf3decodeFromStringTff7b72<Te6edf3ListTff7b72<Te6edf3OfflineRegionTff7b72>Tff7b72>Tb4b4b4(Te6edf3manifestFileTb4b4b4.Te6edf3readTextTb4b4b4(Tb4b4b4)Tb4b4b4)

Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3kotlinxTb4b4b4.Te6edf3serializationTb4b4b4.Te6edf3SerializationExceptionTb4b4b4) Tb4b4b4{

Te6edf3LOGTb4b4b4.Te6edf3wTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffOffline-region manifest is corrupt; treating it as emptyTa5d6ff" Tb4b4b4}

Te6edf3emptyListTb4b4b4(Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

T8b949e// Write-then-rename: a process death mid-write leaves the untouched original (or a stray .tmp file), never a

T8b949e// half-written manifest.json that readManifest's corruption handling would silently mistake for "no regions".

Tff7b72private Tff7b72fun Td2a8ffwriteManifestTb4b4b4(Te6edf3regionsTb4b4b4: Te6edf3ListTff7b72<Te6edf3OfflineRegionTff7b72>Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3tmpFile Tff7b72= Te6edf3FileTb4b4b4(Te6edf3baseDirTb4b4b4, Ta5d6ff"Ta5d6ffmanifest.json.tmpTa5d6ff"Tb4b4b4)

Te6edf3tmpFileTb4b4b4.Te6edf3writeTextTb4b4b4(Te6edf3JsonTb4b4b4.Te6edf3encodeToStringTb4b4b4(Te6edf3regionsTb4b4b4)Tb4b4b4)

Te6edf3FilesTb4b4b4.Te6edf3moveTb4b4b4(

Te6edf3tmpFileTb4b4b4.Te6edf3toPathTb4b4b4(Tb4b4b4)Tb4b4b4,

Te6edf3manifestFileTb4b4b4.Te6edf3toPathTb4b4b4(Tb4b4b4)Tb4b4b4,

Te6edf3StandardCopyOptionTb4b4b4.Te6edf3REPLACE_EXISTINGTb4b4b4,

Te6edf3StandardCopyOptionTb4b4b4.Te6edf3ATOMIC_MOVETb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tff7b72companion Tff7b72object Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3LOG Tff7b72= Te6edf3LoggerTb4b4b4.Te6edf3withTagTb4b4b4(Ta5d6ff"Ta5d6ffOfflineRegionStoreTa5d6ff"Tb4b4b4)

Tb4b4b4}

Tb4b4b4}